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SECTION I 
GENERAL INFORMATION 



1-1. G ENE RAL DESCRIPTI ON 

1-2. This manual contains information and procedures that allow the user to 
write application programs using FORTRAN or Assembly language and RTE Driver 
DVR15. Section III provides information required when configuring DVR15 into a 
Real-Time Executive (RTE) Operating System. 

1-3. The driver is entered through a FORTRAN or Assembly language call to con- 
trol an HP 7261A Card Reader (via a HP 12986A Card Reader Interface Kit) in a 
Real-Time Executive Operating System environment. The driver may be used for 
reading Hollerith data, packed binary data, or column image binary data into an 
area of memory (input buffer) designated by the user. The user initiates the 
reading of a card by executing a calling sequence. The driver can convert 
binary-coded-decimal (BCD) cards, standard HP EBCDIC (extended binary-coded- 
decimal interchange code) cards, and EBCDIC-RDTS (HP 91780 remote data trans- 
mission system) cards. The HP 7261A will read cards having "clock-on-data" or 
"clock-after-data" marks with 80-column type minimum clock-mark spacing. With 
an HP 7261A option 003, 40, or 80-column punched cards, or 40-column marked 
cards without clock marks can be read. If the card is read successfully, the 
driver returns control to the user's program. The user may request card 
reader status informing and the most recent transmission count at any time by 
executing a special calling sequence. 

1-4. OPERATING ENVIRONMENT 

1-5. The operating environment for this software must be: 

a. HP 2100 Series Computer 

b. RTE Operating System 

c. HP 12986A Interface Kit 

Refer to the HP 12986A Operating and Service Manual (HP Part No. 07261-90001) 
for interface kit hardware details. 

1-6. COMPONENTS 

1-7. The following components are included with Driver DVR15: 

a. This manual 

b. Driver DVR15 binary tape, HP Part No. 09601-16021. 
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SECTION II 
APPLICATION INFORMATION 



2-1. GENERAL 

2-2. This section details the calls to the driver and describes any results 
of the hardware/software marriage where the hardware may influence software 
techniques. 

2-3. CALLING SEQUENCES 

2-4. The HP 7261A Card Reader is operated in the Real-Time Executive Oper- 
ating System through FORTRAN, ALGOL, or Assembly language programs calling 
DVR15. These calls are listed in Tables 2-1 and 2-2 and described in Para- 
graphs 2-5 through 2-9. 

2-5. READ CALL 

2-6. This calling sequence (Table 2-1) reads one card through the specified 
card reader. If the read operation is performed satisfactorily, the driver 
returns control to the "return point". To read a deck of cards, it is neces- 
sary to execute the calling sequence repeatedly (once for each card). 

2-7. The maximum possible transmission count after any read operation is as 
follows : 

Hollerith: 80 characters or 40 words 
Packed Binary: 60 words 
Column Image Binary: 80 words 

2-8. The number of words or characters transferred during any read opera- 
tion is as follows: 

Hollerith: Buffer length (IBUFL) or the number of charac- 
ters on the card (not including trailing blanks), 
whichever is smaller. 

Packed Binary: Buffer length (IBUFL) or the count in rows 12-5 
of column 1 of the card, whichever is smaller. 

Column Image Buffer length (IBUFL) or the number of used 
Binary: columns on the card (not including trailing 
blanks), whichever is smaller. 

2-1 
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Table 2-1. HP 7261A Read Calls (DVR15) 



Assembly 




Language 


Where : 




EXT EXEC 






ICODE = Function Code 


JSB EXEC 


1 = Read Request [1 and 3 (Control) are the only 


DEF *+5 


Request Codes accepted by DVR15J 


DEF ICODE 




DEF ICNWD 


ICNWD = Control Word 


DEF IBUFR 


Bits 1 _ Logical Unit Number. The card reader 


DEF IBUFL 


thru 5 j may be assigned up to three logical 


<return point> 


unit numbers: 


. 


LU #N = reader, subchannel 


. 


LU #M = reader, subchannel 1 




LU #L = reader, subchannel 2. 




a. To convert EBCDIC punch set, 




address reader as subchannel 0. 




b. To convert BCD punch set, address 




reader as subchannel 1. 




c. To convert EBCDIC-RDTS punch set, 




address reader as subchannel 2. 




1 , _ 1 = Type of data to be read 




or 2 = Hollerith 




3 = Packed Binary 




1 = Column Image Binary 




Bits 8 1 ., _ , 
, r. ) = Not used 




thru 15 j 




IBUFR = Address of data storage buffer's first word for 




Read call. 




IBUFL = Size of input buffer. Size may be expressed 




either as a number of words or as a number of 




characters. The sign of IBUFL tells the driver 




how to interpret length specification as follows: 




+ = words 




- = characters 




a. If IBUFL is expressed as a number of words, 




transmission count placed in B-Re^ister by 




driver at end of Read operation is also ex- 




pressed as number of words. Likewise, if 




IBUFL is expressed as a number of characters. 




transmission count is expressed as a number 




of characters. 
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Table 2-1. HP 7261A Read Calls (DVR15) (Continued) 





b. An IBUFL should be expressed as a number of 
characters only when reading in Hollerith 
code. 

c. An IBUFL of zero in Hollerith code causes an 
immediate return to user's program (return 
point) with a transmission count of in B- 
Register. 

d. An IBUFL of zero in packed or Column Image 
Binary modes causes one record to be skipped. 
A transmission count of will be returned to 
the user in the B-Register. 


FORTRAN 


CALL EXEC (ICODE.ICNWD.IBUFR, IBUFL) 


ALGOL 


EXEC (ICODE.ICNWD.IBUFR, IBUFL) 



2-8A. CONTROL REQUEST 

2-8B. The calling sequence shown in Table 2-1A will allow the user to perform the following 
functions : 

a. Dynamically determine the current status of the card reader and update the contents 
of word no. 5 of the reader's Equipment Table entry. 

b. Request that the previously-read card be placed in the SELECT HOPPER (option 002), 
instead of the output hopper. 

c. Ring the BELL (option 004) for operator attention. 

Requests b. and c. are processed only when the card reader's hardware status indicates an "O.K. to 
PICK" condition; otherwise, the request is rejected. 

Dynamic Status requests will return the updated contents of Equipment Table Entry, word no. 5, 
in the A-Register. 

2-8C. USING THE BATCH SPOOL MONITOR 

2-8D. The following sequence allows the ringing of the BELL (option 004) when using the batch 
spool monitor. 

: CN, LU, RW LU is the octal number of the logical unit 

or :CN, LU, 4 RW is the Rewind statement 

2-8E. The following sequence allows the selection of the last read card when using the batch spool 
monitor. 

: CN, LU, EDF LU is the octal number of the logical unit 

or : CN, LU, 1 EDF is the End of File statement. 



2-9. STATUS REQUEST 

2-10. This calling sequence (Table 2-2) causes one or two words in the Equipment Table (EQT) to 
be copied into the specified pair of memory locations (ISTA1 and ISTA2). After the information has 
been copied, control returns to the "return point". 

2-11. After a Status Request, ISTA1 contains the card reader status flags. The format of ISTA1 is 

described in Table 2-3. 

ISTA2 contains the most recent transmission count. 
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Table 2-1A. HP 7261A Control Requests (DVR15) 



Assembly 
Language 



EXT EXEC 



JSB EXEC 
DEF *+3 
DEF ICODE 
DEF ICNWD 



Where: 

ICODE 
ICNWD 



= 3 Control Request (processed by DVR15J 
= Control Word 



Bits 
thru 5 

Bits 6 
thru 8 



= Logical Unit Number 

= Subfunction 

6 = DYNAMIC STATUS Request: Update EqT 
word no. 5, and return updated word 
no. 5, to the user, in the A-Register. 

4 = RING the bell, for operator attention. 

1 = SELECT the last card read, and place 
it in the select hopper. 



FORTRAN 



CALL EXEC (3, ICNWD) 

Alternate FORTRAN calls: 

RING the bell: REWIND LU 
SELECT last card: ENDFILE LU 



Where LU is the card reader 
Logical Unit Number. 



ALGOL 



EXEC (3, ICNWD) 



Table 2-2. HP 7261A Status Call (DVR15) 



Assembly 
Language 


Where: 

ICODE = Function Code 

13 - Status Request (processed by 'EXEC, 
does not enter DVR15) . 

ICNWD = Logical Unit Number. 

ISTAl = Card Reader status flags. See Table 2-3 
for format. (EQT word no. 5). 

ISTA2 = May be omitted from calling sequence. 

(EQT word no. 4) Most recent transmission count 


EXT EXEC 

JSB EXEC 

DEF *+4 or [*+5] 

DEF ICODE 

DEF ICNWD 

DEF ISTAl 

[DEF ISTA2] (optional) 

<return point> 


FORTRAN 


CALL EXEC ( 13, LU, ISTAl, ISTA2 (optional)). 


ALGOL 


EXEC (13, LU, ISTAl, ISTA2). 
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Table 2-3. Status Information (ISTA1) 



Bits 


Function 


15-14 


Card reader availability code 

= available 

1 = disabled (down) 

2 = currently busy 

3 = waiting for an available DMA channel 


13-8 


Equipment code 




always = 15 (octal) 


7-0 


Status flags. Meaning when on (1 = on, = off) 




Bit # Status 




Card reader is on-line but not ready or card reader is 
off line. 




1 An illegal Hollerith code was encountered during previous 
read operation or an illegal word count was read in 
packed binary mode. 




2 Not used. 




3 Not used. 




4 Pick failure was sensed after 10 retries. 




5 Previous read request was rejected because the input 

hopper was empty or the output or stacker hoppers were 
full. 




6 Not used. 




7 END OF FILE: the previous read operation left the input 
hopper empty and the last card read was a blank card. 



2-12. 



DATA FORMAT 



2-13. The driver accepts Hollerith data, packed binary data, or column image 
binary data. These modes are described in Paragraphs 2-14 through 2-22. 



2-14, 



HOLLERITH 



2-15. In the Hollerith mode, card codes are converted to ASCII octal equiva- 
lents and stored in the input buffer. Each word in the buffer accommodates 
two codes. The octal equivalent of a code from an odd-numbered card column is 
always stored in bits 8 through 15 of a buffer word while the octal equivalent 
of the code from the next highest even-numbered card column is stored in bits 
through 7 of the same word. Codes are stored in the input buffer consecu- 
tively starting with the first (lowest) buffer word. For example, the codes 
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from card columns 1 and 2 are always stored in the first buffer word, the 
codes from card columns 3 and 4 are always stored in the second buffer word, 
etc. Trailing blanks, though actually read into the buffer, are not included 
in the transmission count returned by the driver at the end of the read 
operation. 

2-16. The driver accepts all 64 standard Hollerith card codes. Table 2-4 
shows the octal equivalents for each code. Note that there are two octal 
equivalents for each code. The lesser value applies if the code is stored in 
bits 0-7 of a word while the greater value applies if the code is stored in 
bits 8-15. 

2-17. All non-valid card codes enter the input buffer as the ASCII code for 
the question mark. 

2-18. With the following six exceptions, every internal ASCII code relates 
directly to the corresponding key on an IBM 029 keyboard. Note that although 
the internal ASCII ! character corresponds with the IBM 029 key, the standard 
and RDTS ASCII octal equivalents are different. 



Internal 
ASCII 

Character 029 Key 

[ * 

/ 00-8-2 

! I 



i 



2-19. PACKED BINARY 

2-20. In the packed binary mode, every four card columns are read into 
("packed into") three buffer words. See Figure 2-1. The relocatable decks 
produced by assemblers and compilers are in packed binary format. A full 
80-column packed binary card fills a 60-word input buffer. In rows 12-5 of 
the first column of each card is a three-digit octal number (row 12, high 
order bit), specifying how many words of data are on the card. The count in- 
cludes itself, since it is read into the input buffer along with the other 
data. 

2-21. COLUMN IMAGE BINARY 

2-22. In the column image binary mode, the information in each card column 
is read into bits 0-11 of a separate buffer word (bits 12-15 are set to 
zeroes). Refer to Figure 2-2. The columns are stored in the input buffer 
consecutively starting with the first (lowest) buffer word. For example, card 
column 1 is always read into the first buffer word, card column 2 is always 
read into the second buffer word, etc. 
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ASCII Octal 


ASCII Octal 


ollerith 


Equivalents 


Equivalents 


Code 


(Standard) 


(for RUTS) 


12-8-2 


133 or 554 


Unassigned 


0-8-2 


134 or 560 


134 or 560 


11-8-7 


135 or 564 


136 or 570 


12-8-7 


136 or 570 


41 or 204 


0-8-5 


137 or 574 


137 or 574 


11-2-8 


41 or 204 


135 or 564 
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Tabl 


e 2-4. EBCDIC Hollerith-to-ASCII Octal 


Equivalents 








ASCII 


ASCII 






Character 




Octal Equivalent 


Character 




Octal Equivalent 






EBCDIC 






Bits 15-8 Bits 7-0 


EBCDIC 




Bits 15-8 


Bits 7-0 






HOLLERITH 


ASCII 




(offset) (true) 


HOLLERITH ASCII 




(offset) 


(true) 




A 


A 


404 101 


6 6 




330 


066 




B 


B 410 102 


7 7 334 


067 


C 


C 414 103 


8 8 340 


070 


D 


D 420 104 


9 9 344 


071 


E 


E 424 105 






F 


F 430 106 


(space) 200 


040 


G 


G 434 107 


! ! 204 


041 


H 


H 440 110 


" (quote) " 210 


042 


I 


I 444 111 


» » 214 


043 


J 


J 450 112 


$ $ 220 


044 


K 


K 4S4 113 


% % 224 


045 


L 


L 460 114 


t, 6 230 


046 


M 


M 464 115 


' (apostrophe) ' 234 


047 


N 


N 470 lib 


( ( 240 


050 





474 117 


) ) 244 


051 


P 


P 500 i:o 


* 250 


0S2 


Q 


Q 504 121 


♦ 254 


053 


R 


R 510 122 


, (comma) , 260 


054 


S 


S 514 123 


- (hyphen or minus)- 264 


055 


T 


T 520 124 


. (period) . 270 


056 


U 


U 524 125 


/ / 274 


057 


V 


V 530 120 


: 350 


072 


w 


W 534 127 


i 1 354 


073 


X 


X 540 130 


360 


074 


Y 


Y 544 131 


364 


075 


Z 


Z 550 132 


370 


076 






? ? 374 


077 





300 ObO 


J ■.' 400 


100 


1 


1 304 Ob 1 


« (cent) [ 554 


133 


2 


2 310 Ob 2 


— 1 (not mark) ] 564 


135 


3 


3 314 063 


! (vertical bar*) t 570 


136 


4 


4 32U 004 


(underscore** ) « 574 


137 


5 


5 324 ObS 


0-8-2 \ 560 

'NUMERIC Y 
"NUMERIC W 


134 
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etc 

10 
9 
8 

7 
6 










etc. 

8 

7 
6 
5 
4 
3 
2 
1 






1 


o 
o 

UJ 

lit 








1 






1 


1 


I 


1 


1 


MEMORY 
WORDS 


COLUMNS 5 




1 




4 
3 
2 

1 


II 10 98765432 10 


1 


7 6 5 4 3 2 1 |l5 14 13 12 


6 7 8 9|I2 II 012345678 


9 






3 2 1 0II5I4I3 12 II 10 9 8 


2 3 4 5 6 7 8 9|i2 II 1 2 3 4 


5 






WMWAMXtoKi 6 5 4 


m/AMVAMMl 7 8 91.211 1 




* 


NOTE: 
1 


12 II 1 234 5 €789 


A 


B 


15 14 13 12 II IC .- 8 7 6 5 4 3 2 1 







Column 1 rows 12-5 contain record 
ength octal value (bits 15 8). 

CARD LAYOUT 


NOTE: Word 1 bits 15 8 contain record 
length octal value (rows 12 5). 

USER BUFFER LAYOUT 






fit. 

10 

9 

8 

7 

6 




u, C 


D 




• f. 

8 

7 
f 

7 
r 

1 


t 


1 


o 












aa> «»Baa»a» 


■a m> 


1 


■" «■ ■■ i "■"" 




• 


a> ■ ■> BB BB 


• •! • • 


MEMORY 
WORDS 


COLUMNS 5 


■■ as aa bb 






4 

3 
2 

1 


aalOaaaaaaaB 5 4 3 2 1 aa 


• • • -| • 


7 6 5 4 3 2 1 0H5 — I3 — 


6*8«|«ll«*«*45 678 


• 






3 2 1 0ll5 I4«I2 II 10 9 8 


2 3 • 5 6 7 8 9,12 1 1 1 2 3 4 


5 






15 1413 12—10 9 ■» 7 6 5 4 


I2ll0l«34«678 9ll2ll0l 






I2/I0l2'45678n 






15 14 13 12 II 10 .-v 8 7 6 5 4 3 2 1 


C 








SAMPLE CARD DATA 


SAMPLE BUFFER STORAGE 









Figure 2-1. Reading Packed Binary 
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(12 EDGE) 



ROW 
12 

11 



1 

2 
3 
4 
5 
6 
7 
8 
9 



f ASMB,R,B,L,T 
I I I 
I I I 

•|ll|l|l|l||l 

i i i 4 t t I ( • a ii it ii 
|l I I I I I I I I I I I 

|2|222|22222 

minimi 

|4444444444 
55551155555 
lllllllllll 

1711)17)))) 
lllllllllll 



looiiiooigi 


lllllll 


Hit nun nan i»»h 
lllllllllll 


a a ii a a * »i 

iiiiii 


111)111)21) 


Di)))) 


lllllllllll 


))I1))I 


44444444444 


1444444 


11111151511 


1515555 


lllllllllll 


lllllll 


lllllllllll 


ll))l II 


lllllllllll 


lllllll 


IIMIHIIII 


lllllll 



lit I lllllll 

ii i. a r a ii a a a •• «i 
lllllllllll 

})))))))))) 

lllllllllll 

44444444444 

55515111551 

iiClllliili 

lllllllllll 

lllllllllll 



lllllllllll 

I i » I I • tan ii ii ii i» « ii ii ii a ii i n n a a n a n a n w i « B a n a a a •' i? «i « ii a 



SIII1IIIIM 



••lllllllllllllll 

a a *i a a a » m u a a a u a a a i> 
I I I I I I I I I I I I I I I I I 

ll)))!211))))))l) 

1111)111)1111)1)1 

44444444444444444 

15511115555555555 

lllllillllillliil 

lllllllllllllllll 

lllllillllillliil 



lllllllllllllllll 

iiaaaiiuuaaanaaati u 



llllllllll 

ii u.i a a ii aa a ii 
llllllllll 


lllllllll 

maaanaaa 

llll ' 1 II 


112)7)2))) 


11)11)))) 


llllllllll 


lllllllll 


4444444444 


144444444 


5555555551 


lllllllll 


llllllllll 


lllllllll 


llllllllll 


))>)>)>) 


llllllllll 


lllllllll 


llllllllll 

uuuaanaa an 


llllltll 

■ naaaiiaaa 
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COLUMNS 1 THROUGH 80 



CARD DATA READ 



ROW ASSIGNED : 



IMONC) 


12 II 12 3 4 3 6 7*9 


(XT TO at 


ONE COLUMN 



ALL BUFFER WORDS 



13 14 13 12 II 10 9 8 7 6 S 4 J 2 I O BITS 

BUFFER WORD ASSIGNMENTS 



CARO 
COLUMN 



3 
4 
S 
(j 
7 
8 
'I 

10 
etc. 



n o o 


D 


■ 


a 





i 














ODD 


o a a 


n 





a 


■ 





■ 

















a 


a 


■ 











1 


a 


a 





Q 


n 


■ 











1 





a 


a 


ODD 














1 





1 











10 











1 

















a 


a o • 


300 





o 





■ 





1 





a 





10 








■ 


a 


a 





1 














o n o 











■ 


a 


■ 


a 








10 





a 





■ 


a 





1 


a 












BUT FUR 

WORD 

1st 

2nd 

3rd 

4th 

5th 

6th 

7th 

8th 

9th 
10th 
etc. 



BUFFER WORDS AFTER DATA TRANSFER 



Figure 2-2. Reading Column Image Binary 
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2-23. REJECTION OF A READ REQUEST 

2-24. Either of the following conditions causes a Read request to be rejected: 

a. The request code of other parameter is illegal. 

b. The specified card reader is not ready. 

When a Read request is rejected, the status information in the Equipment Table 
(EQT) is updated and control passes to the operating system (not to the user's 
program) . 

2-25. DRIVER ORGANIZATION 

2-26. INITIATOR SECTION 

2-27. Upon entry to the initiator section, the RTE system transfers the user 
calling sequence to the storage block defined by the EQTN entry. The A- 
Register contains the I/O address of the Mark Sense Reader interface card. 
The initiator section then configures itself for the appropriate device and 
DMA channels, checks the user parameters for validity and initiates the data 
transfer. 

2-28. If the operation is successfully initiated, control is transferred back 
to the system with a in the A-Register. If the operation is rejected, con- 
trol is passed back to the system with the A-Register set as follows: 

(A) = Error Code* 

= No errors, operation initiated 

1 = Illegal Request 

2 = Control request undefined 

3 = Device inoperable 

4 = Immediate completion (zero characters are requested in ASCII 

mode, no card is fed, or a control request has been processed.) 

All control requests are processed by the initiator section. 

2-29. COMPLETION SECTION 

2-30. Upon entry to the completion section, the A-Register contains either 
the card reader channel number or the DMA channel number. 

2-31. Entry to the completion section is caused by one of the following three 
interrupts : 

a. An error in the Optical Mark Reader is detected. 

b. The end-of-card is detected. 

c. DMA interrupts after 80 columns of data have been input. 



*See appropriate RTE Software and Operating and Service Manual, 
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2-32. The completion section then performs one of the following tasks de- 
pending upon the type of interrupt: 

a. If a reader error is detected, the completion section determines 
the cause and takes the following steps: 

1. Turns off DMA. 

2. Updates status bits in Equipment Table (EQT5) . 

3. Sets A-Register to 1, if not ready or bad hoppers; 
to 3 if pick-failure or bad transmission. 

4. Sets B-Register (transmission log) to 0. 

5. Returns control to system through EXEC. 

b. When end-of-card is detected, the completion section does the 
following: 

1. Clears DMA. 

2. Edits and transfers the accumulated data from the inter- 
nal buffer into the user's buffer according to the Read 
function. 

3. Sets the B-Register (transmission log) to the number of 
characters or words transferred. 

4. Sets the A-Register = 0„ to indicate successful completion. 

5. Returns control to the system through EXEC. 

c. When DMA interrupts, the completion section does the following: 

1. Turns off DMA. 

2. Makes a continuation exit to await the device end-of-card 
interrupt. 
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SECTION III 
CONFIGURATION INFORMATION 



3-1. GENERAL 

3-2. This section provides configuration information for Driver DVR15 unci is 
intended to augment the data provided in the Real-Time Executive Software System 
Programming and Operating Manual. 

3-5. REAL-TIME GENERATION 

3-4. The driver is loaded into the RTE System during system generation as 
described in the appropriate RTE Software Manual. At this time, the following 
items must be supplied by the operator to configure the HP 7261A Card Reader 
into the system being generated. 

3-5. PROGRAM INPUT PHASE 

3-6. Driver DVR15 must be loaded during this phase. 

3-7. TABLE GENERATION PHASE 

3-8. In this phase, the following three entries must be made: 

a. An Equipment Table entry for each HP 7261A Card Reader: 

"EQUIPMENT TABLE ENTRY 

nn,DVR15,D 

where "nn" is the select code of the card reader interface card, 
and D specifies the use of a DMA channel. 

b. A Device Reference Table entry for each HP 7261A Card Reader 
"DEVICE REFERENCE TABLE 



xx = EQT#? 
m 



where xx is a logical unit number. Response "m" is a number 
that corresponds to the "nn,DVR15,D" position in the Equipment 
Table 
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c. An Interrupt Table entry for each card reader interface card: 
* INTERRUPT TABLE 

nn,EQT,m 



where "nn" is again the select code of the interface card, and 
'm' is the EQT number. 
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READER COMMENT SHEET 
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